home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / modcom21.zip / MODCOM.DOC < prev    next >
Text File  |  1994-05-29  |  7KB  |  165 lines
  1.                 
  2.  
  3.           ┌┬─────────────────────────────────────────────────────┬┐
  4.           │├────────────         MODCOM 2.1          ────────────┤│
  5.           │├────────────   MOD Commenting Utility    ────────────┤│
  6.           │├────────────     by Brett Lucey '94      ────────────┤│
  7.           │├─────────────────────────────────────────────────────┤│
  8.           │├──────────── Idea & dox by Tom Grandgent ────────────┤│
  9.           └┴─────────────────────────────────────────────────────┴┘
  10.  
  11.           Introduction:  What is MODCOM?
  12.  
  13.               MODCOM is a program that will place comments (mainly
  14.           BBS advertisements) into Amiga music format files, aka
  15.           MODs.  MODCOM was created so sysops can advertise their
  16.           BBSs in MOD files, and (in the registered version) it will
  17.           process multiple MODs in one pass, even if they are
  18.           compressed.
  19.  
  20.           Thanks to..
  21.  
  22.               I would really like to thank Tom Grandgent here, because
  23.           originally MODCOM was his idea.  He gave me the source code
  24.           to it, and I rewrote the whole thing over again, and beefed 
  25.           it up with lots of features, and more configurability.
  26.  
  27.                                                 - Brett Lucey
  28.           
  29.           The Sample-Text-Saver-System:
  30.  
  31.               I know what you're thinking:  Isn't this program going
  32.           to ruin all the fun-to-read sample texts?!  The answer is
  33.           NO!  MODCOM was designed to first look for a Music Channel
  34.           BBS advertisement (don't you just HATE those?  They always
  35.           overwrite sample text!).  If it finds one it will be
  36.           overwritten with your text.  If it doesn't find one, it
  37.           will search the sample text for a blank space big enough
  38.           for your text.  If it doesn't find any blank space then it
  39.           will put your text at the top of the second column (on the
  40.           DMP screen at least).
  41.  
  42.  
  43.           Supported MOD Formats:
  44.  
  45.               MODCOM doesn't just do traditional four-channel .MOD
  46.           files- it will process a wide variety of similar modules,
  47.           as shown below:
  48.  
  49.                      Extension │ Channels │ Signature
  50.                      ──────────┼──────────┼──────────
  51.                        .MOD    │    4     │ M.K.
  52.                        .MOD    │    4     │ M!K!
  53.                        .MOD    │    4     │ 4CHN
  54.                        .MOD    │    4     │ FLT4
  55.                        .MOD    │    6     │ 6CHN
  56.                        .MOD    │    8     │ 8CHN
  57.                        .MOD    │    8     │ FLT8
  58.  
  59.               .MTM files will be supported in the next release.
  60.  
  61.  
  62.           Usage:
  63.  
  64.               MODCOM MODNAME.MOD COMMENTS.TXT
  65.  
  66.               Wildcards are also acceptable, so this would be fine:
  67.  
  68.               MODCOM *.MOD COMMENTS.TXT
  69.               MODCOM ??ABC*.MOD COMMENTS.TXT
  70.  
  71.               MODNAME.MOD is obviously the filename(s) of the
  72.           MOD(s), and COMMENTS.TXT contains the comment lines you
  73.           want placed into the MOD(s).  You can have a maximum of 2
  74.           lines in the shareware version, but in the registered one
  75.           you get a max of 6 lines.
  76.  
  77.               In the shareware version, the first comment line is automatic.
  78.           The second two lines are whatever you want.  The first line is:
  79.           "THIS MOD IS FROM...", without the quotes.  This was mainly to
  80.           get sysops to register.   More on registration later.  Now to the
  81.           good part!
  82.  
  83.           Setup & Installation:
  84.  
  85.               First, unpack the zip file.  There should be 5 files:
  86.  
  87.                 MODCOM.EXE - Main file (v 2.1)
  88.                 MODCOM.DOC - This file
  89.                 MODCOM.CFG - Sample Comment file
  90.                 DISCLA.TXT - Official MODCOM disclaimer
  91.                 REGIST.FRM - Registration form
  92.                 FILE_ID.DIZ - Description file        
  93.  
  94.         1) Copy MODCOM.EXE into a directory included in your path.
  95.         
  96.         2) Create a text file, name it whatever you wish.  In this text file, 
  97.                 there can be up to two lines, consisting of 22 characters each.
  98.                 I reccomend filling the unused characters with spaces.  A CR at
  99.                 the end of the line tells modcom to go onto the next, or it reads
  100.                 22 chars, whichever comes first.  For the last or third line (same
  101.                 thing!) put the file where you would like logs to be kept.  This
  102.                 is a new feature in version 2.1!
  103.  
  104.         3) Go into your BBS software reference and find out the name of the batch
  105.                 file that tests uploads.  In PCBoard (copyright, Clark Development 
  106.                 Software), this would be PCBTEST.BAT.
  107.  
  108.         4)  Add the line, "MODCOM arguments"  where arguments is something like
  109.                 %1 %2 %3 or whatever.  If you are a sysop, you should know what I
  110.                 mean.  Make sure you use the FULL path to the filename:  
  111.                         C:\MOD\ACOUSTIC.MOD
  112.  
  113.         5)  Upload a mod, and watch it be commented.  Then, go to the mod and play
  114.                 it with your mod player.  In a portion of blank space there should
  115.                 be your ad!
  116.  
  117.           REGISTRATION (ADVANTAGES/HOW TO DO IT) :
  118.  
  119.                To register, just fill out the registration form, -OR-
  120.           for prompt registration, call The Wizard's BBS, and run the
  121.           online registration program.  You can create a new account
  122.           with ease, and get access immediately with a CBV program.
  123.           When you get to the main menu, type:  MODREG.  (This is 
  124.           currently NOT available.  This will come into effect as of
  125.           May 10th, 1994)  The rest is explained.  The registration is 
  126.           only $15, which is a fair price.
  127.  
  128.           Registration features:
  129.  
  130.                 o  Updates, free of charge.  You can send me a disk, and SASE
  131.                    or call Wizard's BBS, and get the updates there.
  132.  
  133.                 o  The BBS ad is Hard Coded.  
  134.  
  135.                 o  There is NO charge for getting the BBS ad changed!
  136.                 
  137.                 o  Compressed MOD support (.ZIP)
  138.                 
  139.                 o  NO ANNOY-O-METER
  140.                 
  141.                 o  Up to 6 lines of comments
  142.                 
  143.                 o  Log file support
  144.  
  145.  
  146. -------------------------------
  147.  *  SUPPORT AND BETA SITES  *
  148. ------------------------------                  
  149.  
  150.                   To get the latest versions, or for support call:
  151.                         
  152.                         The Wizard's BBS
  153.                         SysOp:  The Wizard
  154.                         6+ Gig Online, 100's Of RIME Conferences
  155.                         10 Lines, on Hunt
  156.  
  157.                         [508]481-4693
  158.                         
  159.         --- BRETT LUCEY ---             --- TOM GRANDGENT ---
  160.      --- AUTHOR OF MODCOM! ---         --- DOCUMENT AUTHOR ---
  161.  
  162.                         ModCom Copyright (C) 1994
  163.                       ModCom Pro Copyright (C) 1994
  164.                  ModCom Pro Companion Copyright (C) 1994
  165.